home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / dormn201.zip / DORMENU.DOC < prev    next >
Text File  |  1992-01-27  |  10KB  |  216 lines
  1.  
  2.                                  D O R M E N U
  3.                                   Version 2.01
  4.                         Release Date: September 30, 1991
  5.  
  6.                    (C) Copyright 1989,1991 - All Rights Reserved
  7.  
  8.                              a PCBoard 14.x door
  9.  
  10.                  developed & written By D.J. Cheeks and L.E.Fox
  11.  
  12.                                  The Modem Zone
  13.                                 108 Curtis Street
  14.                              Middletown, Ohio  45044
  15.  
  16.                       (513) 424-7529 (DUAL) / 424-7794 (HST)
  17.                                 424-8347 (CompuCom)
  18.                             Voice support  424-6483
  19.                             FAX  424-5820
  20.  
  21.                           Documentation edited by L.E.Fox, D.J.Cheeks
  22.  
  23.     
  24.     Overview
  25.     ~~~~~~~~
  26.     User selects a menu item from bbs doors list, which will then run
  27.     DorMenu. The menu file that you created will be shown to the user.
  28.     The user then chooses a selection. DorMenu reads the .DAT file
  29.     (ie. ARCADE.DAT) counting the lines read until the number of lines
  30.     read matches the selection made by the users, or end of the dat file
  31.     is reached. If a match was found then DorMenu checks to see if the
  32.     time and security levels have been included, if the time or security
  33.     has been included then DorMenu will compare the users time and/or
  34.     security level to those in the .DAT file. If time and security are
  35.     included then Dormenu will first compare the time to insure that the
  36.     caller has enough time remaining, then will check to see that the
  37.     users security is equal to or greater than the .DAT file security
  38.     level. You can do any combination with the time and security. If
  39.     DorMenu passes these test then the name that was read in from the
  40.     .DAT file will be loaded into the batch file name that is in the
  41.     .CNF file, DorMenu then exits and the next line in the batch file
  42.     after DorMenu will execute the batch file whose name is in the .cnf
  43.     file. If you've included the line "if exist door.bat door" in the
  44.     files then DorMenu will reload else the bbs will be reloaded.
  45.  
  46.     Files included in this ZIP:
  47.     ~~~~~ ~~~~~~~~ ~~ ~~~~ ~~~~
  48.     DorMENU     - Same batch file to run DorMENU, different name (PCB directory
  49.                   The remainder of the files should be put in a doors directory
  50.     DorMENU.EXE - Main executable file to be placed in other than PCB directory
  51.     DorMENU.DOC - These Pulitzer quality docs (hey, watch your language!)
  52.     DorMENU.CNF - Sample config file - must be in same directory as the .exe
  53.     Arcade.DAT  - Sample dat file - must be in same directory as the .exe
  54.     Arcade(g)   - Sample menu file - must be in same directory as the .exe
  55.     Motu        - Sample batch file - must be in same directory as the .exe
  56.     Order.Doc   - How to get a registered version of DorMemu
  57.     and other misc sample files from our bbs
  58.  
  59.     DorMENU Configuration:
  60.     ~~~~~~~ ~~~~~~~~~~~~~
  61.  
  62.        The DorMENU.CNF file must contain the following information:
  63.  
  64.        line  1 = Driver type (HANDSHAKE, INTERRUPT, BIOS, PCBTRAP)
  65.        line  2 = Welcome message filename     \
  66.        line  3 = Main menu filename            \__ PCB color codes supported
  67.        line  4 = Closing door message filename /
  68.        line  5 = Name of BAT file to run door
  69.        line  6 = Name of DAT file that contains doors to run
  70.        line  7 = Name of BBS
  71.        line  8 = Name of Sysop
  72.        line  9 = Serial nbr
  73.        line 10 = Registration nbr
  74.  
  75.  
  76.        It will look similar to this:
  77.          INTERRUPT
  78.          dwelcom
  79.          ARCADE
  80.          dclose
  81.          arcade.bat
  82.          arcade.dat
  83.          Modem Zone
  84.          Don & Lana
  85.          00000
  86.          00000000
  87.  
  88.        The configuration file must be located in the default directory
  89.      (i.e. C:\PCB\DOORS\CASINO or whatever) along with the DorMENU.exe file.
  90.  
  91.     Invocation Batch File:
  92.     ~~~~~~~~~~ ~~~~~ ~~~~
  93.  
  94.        As you most likely already know, PCBoard uses batch files associated
  95.     with each door to take care of changing directories, executing the file,
  96.     returning the user to PCBoard, etc. An example of the batch file to use
  97.     for DORMENU, called CASINO, is included.  In addition, DorMENU will look
  98.     for the batch files to run the selected doors in the default (DorMENU)
  99.     directory.  This is so you can run multiple DorMENUs.
  100.  
  101.     Placement of DorMENU files:
  102.     ~~~~~~~~~ ~~ ~~~~~~~ ~~~~~
  103.        1) Customize (edit) DORMENU (the batch file), for your system and
  104.           put it in the BBS directory.
  105.        2) Place DORMENU.EXE in your DOORS directory (i.e.
  106.           \PCB\DOORS\CASINO).
  107.        3) Customize DORMENU.CNF (the config file), for your system and
  108.           put it in your DOORS directory (must be in same directory as
  109.           DORMENU.EXE).
  110.        4) Place all the batch files to run selected door in the same
  111.           directory as DORMENU.EXE and DORMENU.CNF.
  112.        5) Be sure to add CASINO (or what ever you called the file) to
  113.           your DOORS.DAT file.
  114.  
  115.           Example of DORMENU invocation file (place in bbs default dir):
  116.           ~~~~~~~ ~~ ~~~~~~~ ~~~~~~~~~~ ~~~~
  117.    @echo off                          <- Turns screen off
  118.    c:                                 <- Change to DorMenu drive
  119.    cd\pcb\doors\arcade                <- Change to DorMenu directory
  120.    if exist arcade%PCBNODE%.bat del arcade%PCBNODE%.bat
  121.                                       ^- Clean up any old batch files
  122.    dormenu arcade.cnf C:\pcb          <- runs DorMenu
  123.                       ^----------------- use this for PCBoard.sys
  124.                       C:\WC\DOOR.SYS  <- use this for DOOR.SYS
  125.                       ^----------------- where ever door.sys is located
  126.    if exist arcade%PCBNODE%.bat arcade%PCBNODE%.bat
  127.                                       ^- runs the selected door
  128.    c:                                 <- return to bbs
  129.    cd\pcb                             <- change to bbs directory
  130.    if exist event.bat event           <- check for pending event
  131.    board                              <- brings bbs back on line
  132.   ** NOTE **
  133.       PCBNODE is used only if you are running a multi-node system
  134.       ie.. SET PCBNODE = 1   --- when DorMenu runs PCBNODE will be
  135.                                  changed by DOS to say 1, so the
  136.                                  line above would say ARCADE1.BAT
  137.                                  at execution time.
  138.                          ie..... if exist arcade1.bat arcade1.bat
  139.  
  140.           Example of Batch file (MOTU) to run DorMENU selection:
  141.           ~~~~~~~ ~~ ~~~~~ ~~~~  ~~~~  ~~ ~~~ ~~~~~~~ ~~~~~~~~~
  142.    @echo off               <- Turns screen echo off
  143.    c:                      <- changes to selected door drive
  144.    cd\pcb\doors\pb203      <- Changes to selected door subdirectory
  145.    pbexec PBUSTPRM.TXT     <- Runs selected door
  146.    pbplay PBUSTPRM.TXT     <- Runs selected door
  147.    C:                      <- changes back to bbs drive
  148.    cd\pcb                  <- changes back to bbs directory
  149.    if exist door.bat door  <- if this file exist then DorMenu will reload
  150.    board                   <- else the bbs will reload
  151.  
  152.           Example of Dat file (Arcade.Dat) to run DorMENU selection:
  153.           ~~~~~~~ ~~ ~~~ ~~~~  ~~~~~~~~~~~ ~~ ~~~ ~~~~~~~ ~~~~~~~~~
  154.           MOTU,10,30
  155.              |  |  ^------------ security level to access door
  156.              |  |_______________ time remaining required to access door
  157.              |__________________ file name to load in to the batch
  158.                                  file to run the selected door.
  159.           TradeWar,,30
  160.           PBuster,,30
  161.           STrek,,30
  162.           Amoeba,,30
  163.           OOII,,30
  164.           DarkStrm,30,30
  165.           MegaVers,,30
  166.  
  167.     Distribution Information:
  168.     ~~~~~~~~~~~~ ~~~~~~~~~~~
  169.  
  170.        You are free to copy and give this program to anyone, but we ask that
  171.     you please keep all the files unchanged in the archieve. To receive your
  172.     registered version of the program, see Order.Doc in this ZIP.
  173.  
  174.        If you have any problems or questions, please call us voice (the
  175.     number is is in the ORDER.DOC) and let us know. The latest release
  176.     of DorMenu and our other door programs are always available for D/L.
  177.        
  178.        Well, that's it! We hope you find DorMenu useful!
  179.   
  180.                                                      Thanks,
  181.                                                  ->Don and Lana<-
  182. Revision history
  183. 10-25-91    v2.01  Fixed the comm problem with DOOR.SYS. Fixed the
  184.                    time problem with DOOR.SYS.
  185.                    If you use DOOR.SYS or any of the other non-PCB
  186.                    systems you must set the following enviroment
  187.                    string:
  188.                           COMM 1 --> SET COMBASE=1016
  189.                                      SET COMRIQ=4
  190.                           COMM 2 --> SET COMBASE=760
  191.                                      SET COMRIQ=3
  192.                           COMM 3 --> SET COMBASE=1000
  193.                                      SET COMRIQ=4
  194.                           COMM 4 --> SET COMBASE=744
  195.                                      SET COMRIQ=3
  196.                    DorMenu will handle up to 8 comm ports
  197.  
  198. 09-30-91    v2.00  Added support for DOOR.SYS, Updated the doc files,
  199.                    Added .DAT file format to allow security and time
  200.                    checking before allowing caller to open door.
  201. 07-01-91    v2.00  Beta started
  202. 07-16-90    v1.51  Compiled using ProKit 3.2 release, and add close down
  203.                    door.
  204. 03-04-90    v1.5   Fixed dropped carrier problem, minimized opening screen
  205.                    in registered versions.
  206. 02-26-90    v1.4   Added support for registered SysOps by popular request
  207. 01-01-90    v1.3   Compiled using Turbo Pascal 5.5, ProKit 3.1, and a minor
  208.                    bug that caused an occasional door to return to the main
  209.                    board on exit.
  210. 01-23-89    v1.2   Compiled using Turbo Pascal 5.0
  211. 01-05-89    v1.1   Minor bug fix in SysOp Display.  Added printer logging.
  212.                    Now allows User-defined batch file name so DorMENU could
  213.                    now be run from the PCB directory without conflict.
  214. 12-26-88    v1.0   Initial coding
  215.  
  216.